home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / shell-tools / fsearch / fsearch.dok < prev    next >
Text File  |  1996-04-12  |  5KB  |  110 lines
  1. ----------------------------------------------------------------------
  2.                              FSearch 1.2
  3. ----------------------------------------------------------------------
  4. Only german documentation available yet.
  5. ----------------------------------------------------------------------
  6. Achtung!
  7. Das Programm benötigt mindestens das Betriebssystem 'Kickstart 2.0'
  8. Ein Aufruf unter Kick 1.x führt zum vorzeitigen Abbruch des Programms.
  9. ----------------------------------------------------------------------
  10. FSearch ist ein Programm zum Durchsuchen einer Datei nach einer
  11. angebbaren Zeichenkette. Es kann das Programm 'Search' von der
  12. original Workbench Diskette in den allermeisten Anwendungsfällen
  13. ersetzen. Lediglich auf die Dateisuche und auf eine Suche mit
  14. Jokerzeichen (Pattern) in der zu suchenden Zeichenkette wurde
  15. verzichtet. Jokerzeichen im Dateinamen sind allerdings erlaubt!
  16. Dieses Programm habe ich geschrieben, da der original Search nicht
  17. gerade schnell ist (Daher FSearch für Fast Search). Es gibt zwar
  18. bereits diverse weitere Varianten dieses Programms, teilweise war
  19. mir der Geschwindigkeitsgewinn jedoch nicht hoch genug oder die
  20. Programme fanden nicht alle Vorkommen der zu Suchenden Zeichenkette!
  21. ----------------------------------------------------------------------
  22. Das Programm ist in der derzeitigen Version FreeWare, darf also zur
  23. privaten Weitergabe kopiert werden, das Copyright bleibt jedoch beim
  24. Autor. Es darf nicht verkauft bzw. zu kommerziellen Produkten hinzu-
  25. gefügt werden.
  26. Bei der privaten Weitergabe ist darauf zu achten, daß das Programm
  27. FSearch einschließlich dieser DOK-Datei weitergegeben wird.
  28.  
  29. Die Verbreitung in PD-Serien ist nur mit vorhergehender Genehmigung
  30. des Autors erlaubt. Die Genehmigung für die AmiNET CDs gilt hiermit
  31. als erteilt!
  32.  
  33. Über eMails an ehb@draco.prima.ruhr.de würde ich mich freuen.
  34.  
  35. Vieleicht hat auch mal jemand lust, mir als kleine Anerkennung für
  36. dieses Programm eine englische Übersetzung dieser Dokumentation zu
  37. erstellen. Um unnötig doppelte Arbeit zu vermeiden wäre eine vorherige
  38. eMail sinnvoll.
  39. ----------------------------------------------------------------------
  40. Syntax:
  41.  
  42. FSearch FILE STRING [ALL CASE FULL WORD BEGIN END NONUM FIRST QUIET]
  43.  
  44. FILE:   Hier die zu durchsuchende Datei bzw. das zu dursuchende
  45.         Verzeichnis angeben. (evtl. mit Pfadangaben, Pattern erlaubt!)
  46.  
  47. STRING: Zeichenkette, nach der gesucht werden soll.
  48.  
  49. Sind in den Parametern Leerzeichen enthalten, müssen diese Parameter
  50. einzeln von Anführungszeichen eingerahmt sein.
  51.  
  52. z. B. : FSearch Fishliste "Fish 23"
  53.  
  54. Optionale Parameter:
  55.  
  56. ALL     Ist der angegebene Dateiname ein Verzeichnis oder passt ein
  57.         Verzeichnis auf die angegebenen Jokerzeichen, wird dieses nur
  58.         durchsucht, wenn der Parameter ALL angegenben wird!
  59.  
  60. CASE    case sensitive Suche (Unterscheidung Groß/Kleinbuchstaben)
  61.  
  62. FULL    Es werden maximal 512 Zeichen pro gefundener Zeile Ausgegeben
  63.         (sonst nur 80 inklusive Zeilennummer).
  64.  
  65. WORD    Es wird nur ein vorhandensein der Zeichenkette angezeigt, wenn
  66.         diese in der Datei rechts und links von Zeichen eingerahmt ist,
  67.         die kleiner $40 sind oder zwischen $7F und $C0 liegen.
  68.  
  69. BEGIN   Wie WORD (Testet jedoch nur das vorhergenende Zeichen.)
  70.  
  71. END     Wie WORD (Testet jedoch nur das nachfolgende Zeichen.)
  72.  
  73. NONUM   Die Ausgabe der Zeilennummer wird unterdrückt.
  74.  
  75. FIRST   Die Suche wird nach dem ersten Vorkommen der zu suchenden
  76.         Zeichenkette abgebrochen.
  77.  
  78. QUIET   Die Ausgabe des Dateiamens erfolgt nur bei mindestens einmaligem
  79.         Vorkommen der angegeben Zeichenkette in der zu durchsuchenden
  80.         Datei. (Sinnvoll bei Ausgabeumlenkung)
  81.         (Ausnahme: Bei Abbruch mittels Ctrl-C)
  82. ----------------------------------------------------------------------
  83. Rückgabewerte:
  84.  
  85.         0: Gefunden
  86.         5: Nicht Gefunden
  87.        20: Abbruch bei Initialisierung (falsche Kickstart etc.)
  88. ----------------------------------------------------------------------
  89. Das Programm ist Resident-Fähig!
  90. Das p-Bit sollte also gesetzt sein.
  91. ----------------------------------------------------------------------
  92. History:
  93.  
  94. Version 1.0 : 11.  8. 90
  95. Version 1.1 :  1. 11. 90
  96.               Anpassung an Kick 2.02 (ReadArgs Problem)
  97. Version 1.2 : 12.  4. 96
  98.               Nachdem ich Version 1.1 ins AmiNet upgeloadet hatte bekam
  99.               ich eine Reihe von Verbesserungs-Vorschlägen. Also habe
  100.               ich den alten Source ausgegraben und schon mal die
  101.               folgenden implementiert:
  102.               - NONUM und FIRST Parameter
  103.               - RETURN_WARN (5) wenn String nicht gefunden wurde
  104.               - ExtHelp
  105.  
  106. Weitere Ergänzungen sind für die Version 2.0 geplant.
  107. ----------------------------------------------------------------------
  108.                                         Edwin H. Bielawski 12. 4. 1996
  109. ----------------------------------------------------------------------
  110.